package com.youlai.boot.form.service;

import com.youlai.boot.form.model.entity.FormDefinition;
import com.youlai.boot.form.model.form.FormDefinitionForm;
import com.youlai.boot.form.model.query.FormDefinitionQuery;
import com.youlai.boot.form.model.vo.FormDefinitionVO;
import com.baomidou.mybatisplus.core.metadata.IPage;
import com.baomidou.mybatisplus.extension.service.IService;

/**
 * 动态单定义服务类
 *
 * @author rabit
 * @since 2025-10-27 16:47
 */
public interface FormDefinitionService extends IService<FormDefinition> {

    /**
     *动态单定义分页列表
     *
     * @return {@link IPage<FormDefinitionVO>} 动态单定义分页列表
     */
    IPage<FormDefinitionVO> getFormDefinitionPage(FormDefinitionQuery queryParams);

    /**
     * 获取动态单定义表单数据
     *
     * @param id 动态单定义ID
     * @return 动态单定义表单数据
     */
    FormDefinitionVO getFormDefinitionFormData(Long id);

    /**
     * 新增或者保存动态单定义
     * 会自动增加历史或者更新版本号
     * @param formData 动态单定义表单对象
     * @return 是否新增成功
     */
    Long saveOrUpdateFormDefinition(FormDefinitionForm formData);

    /**
     *  更新或者保存动态表单
     * @param entity 表单实体
     * @return 是否成功
     */
    Long updateFormDefinition(FormDefinition entity);

    /**
     * 删除动态单定义
     *
     * @param ids 动态单定义ID，多个以英文逗号(,)分割
     * @return 是否删除成功
     */
    boolean deleteFormDefinitions(String ids);

    /**
     * 更新动态单定义状态
     *
     * @param id 动态单定义ID
     * @param status 状态 0启用 1停用,2历史版本
     * @return 是否更新成功
     */
    boolean updateFormDefinitionStatus(Long id, Integer status);

    /**
     * 回滚动态单定义历史
     *
     * @param formCode 表单编码
     * @param version 版本
     * @param rollbackFromOperator 操作人
     * @return 是否回滚成功
     */
    boolean rollbackFormDefinitionHistory(String formCode, Long version, Long rollbackFromOperator);
}
